home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / c / snippet.exe / ENUMS.TXT < prev    next >
Encoding:
Text File  |  1992-07-03  |  2.1 KB  |  56 lines
  1. Some of my favorites...
  2. -----------------------
  3.  
  4. typedef enum {ERROR = -1, SUCCESS, FALSE = 0, TRUE} logical;
  5. #define BOOL(x) (!(!(x)))                       /* always TRUE or FALSE */
  6.  
  7. /* (trivial) Example code follows               */
  8.  
  9. #define MAX_VAL 10000                           /* data upper bound     */
  10. #define MIN_VAL -37                             /* data lower bound     */
  11.  
  12. logical testfunc(int intvalue)
  13. {
  14.         if (MAX_VAL < intvalue || MIN_VAL > intvalue)
  15.                 return ERROR;                   /* if out of bounds     */
  16.         else    return BOOL(intvalue);          /* zero returns FALSE,
  17.                                                    anything else is TRUE*/
  18. } 
  19.  
  20. /* Examples using SUCCESS/ERROR                 */
  21.  
  22.         if (SUCCESS == strcmp(my_string, "something"))
  23.                 do_something();
  24.         if (ERROR == open("my_file", O_READ))
  25.                 abort();
  26.  
  27.   And, speaking of enumerated data types (which we can feel free to do
  28. since they're now "official" with the adoption of ANSI C), these are very
  29. handy when defining lists of data which may need to be appended in the
  30. future. If you define your enums this way:
  31.  
  32. enum CARS {CARS_MIN = -1, FORD, CHEVY, PLYMOUTH, CARS_MAX};
  33.  
  34. ...then you can write "expandable" code as follows:
  35.  
  36. logical real_car(enum CARS my_car)
  37. {
  38.         if (CARS_MIN >= my_car || CARS_MAX <= my_car)
  39.                 return FALSE;
  40.         else    return TRUE;
  41. }
  42.  
  43. By including `CARS_MIN' and `CARS_MAX' as dummy enumerations, you can
  44. change the declaration to:
  45.  
  46. enum CARS {CARS_MIN = -1, FORD, CHEVY, PLYMOUTH, FERRARI, CARS_MAX};
  47.  
  48. ...and all your existing code will still work properly, allowing you to
  49. spend your time writing new code to support the new enumerations rather
  50. than going back to fix any bounds checking you may have already written.
  51. In addition if, within the enum declaration, you declare `CARS_MIN = -1',
  52. then you can also include this handy little bit of expandable code:
  53.  
  54.         printf("Right now, I know about %d type%s of CARS\n", CARS_MAX,
  55.                 &"s"[1 == CARS_MAX]);
  56.